home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / FCOMP101.ARJ / FCMANUAL.DOC < prev    next >
Text File  |  1992-01-10  |  38KB  |  967 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                             ────────────────────
  11.  
  12.                                     FCOMP
  13.  
  14.  
  15.  
  16.  
  17.                             █▀█
  18.                             █     Gamma Software
  19.  
  20.  
  21.                             ────────────────────
  22.  
  23.  
  24.                               COPYRIGHT
  25. _____________________________________________________________________
  26.  
  27.  
  28.    COPYRIGHT
  29.    ---------
  30.    Copyright 1991 by Gamma Software.  All rights reserved.
  31.  
  32.    TRADEMARKS
  33.    ----------
  34.    IBM PC, PC/XT,PC/AT and PS/2 are registered trademarks of
  35.    International Business Machines, Inc.
  36.  
  37.    DISCLAIMER
  38.    ----------
  39.    Users of FCOMP must accept this disclaimer of warranty:
  40.    FCOMP is supplied as is.  The author disclaims all
  41.    warranties, expressed or implied, including, without limitation,
  42.    the warranties of merchantability and of fitness for any purpose.
  43.    The author assumes no liability for damages, direct or conse-
  44.    quential, which may result from the use of FCOMP.
  45.  
  46.    DEFINITION OF SHAREWARE
  47.    -----------------------
  48.    Shareware distribution gives users a chance to try software
  49.    before buying it. If you try a Shareware program and continue
  50.    using it, you are expected to register. Individual programs
  51.    differ on details -- some request registration while others
  52.    require it, some specify a maximum trial period. With
  53.    registration, you get anything from the simple right to continue
  54.    using the software to an updated program with printed manual.
  55.  
  56.    Copyright laws apply to both Shareware and commercial software,
  57.    and the copyright holder retains all rights, with a few specific
  58.    exceptions as stated below. Shareware authors are accomplished
  59.    programmers, just like commercial authors, and the programs are
  60.    of comparable quality. (In both cases, there are good programs
  61.    and bad ones!) The main difference is in the method of
  62.    distribution. The author specifically grants the right to copy
  63.    and distribute the software, either to all and sundry or to a
  64.    specific group. For example, some authors require written
  65.    permission before a commercial disk vendor may copy their
  66.    Shareware.
  67.  
  68.    Shareware is a distribution method, not a type of software. You
  69.    should find software that suits your needs and pocketbook,
  70.    whether it's commercial or Shareware. The Shareware system makes
  71.    fitting your needs easier, because you can try before you buy.
  72.    And because the overhead is low, prices are low also. Shareware
  73.    has the ultimate money-back guarantee -- if you don't use the
  74.    product, you don't pay for it.
  75.  
  76.  
  77.  
  78.  
  79.  
  80. _____________________________________________________________________
  81.                                   i
  82.  
  83.                             REGISTRATION 
  84. _____________________________________________________________________
  85.  
  86.  
  87.    REGISTRATION AGREEMENT
  88.    ----------------------
  89.    FCOMP is a "shareware program" and is provided at no charge to the 
  90.    user for evaluation.  Feel free to share it with your friends, but 
  91.    please do not give it away altered or as part of another system.  
  92.    The essence of "user-supported" software is to provide personal 
  93.    computer users with quality software without high prices, and yet 
  94.    to provide incentive for programmers to continue to develop new 
  95.    products.  This is not free software, if you continue to use FCOMP 
  96.    after a reasonable trial period, you MUST make a registration 
  97.    payment of $15.00 to Gamma Software or discontinue use.  In order
  98.    for Gamma Software to be able to continue developing this product
  99.    we must receive support from those people who use it.  We receive 
  100.    no portion of any fees paid to shareware distributors.  See the 
  101.    next section, "How To Register", for details on how to register.
  102.  
  103.    If you do not continue to use the program, but would like to offer
  104.    suggestions for future changes/enhancements to the program that 
  105.    would make it useful to you then send them to the address below.
  106.    If any of your suggestions are implemented and you would like to
  107.    be notified when they are made then indicate such and also include
  108.    your address or Compuserve ID.
  109.  
  110.    The $15.00 registration fee will license one copy for use on any one 
  111.    computer at any one time.  You must treat this software just like a 
  112.    book.  An example is that this software may be used by any number of 
  113.    people and may be freely moved from one computer location to another, 
  114.    so long as there is no possibility of it being used at one location 
  115.    while it's being used at another.  Just as a book cannot be read by 
  116.    two different persons at the same time.
  117.  
  118.    Commercial users of FCOMP must register and pay for their copies of 
  119.    FCOMP within 30 days of first use or their license is withdrawn.  
  120.    Site-Licenses available.  See the "How To Register" section, below.
  121.  
  122.    FCOMP cannot be distributed for any kind of remuneration.  It is 
  123.    permissible for distributors to charge a nominal fee (usually not
  124.    more than $5) for the disk that FCOMP is shipped on plus shipping
  125.    and handling.  No fee can be charged for the FCOMP software itself.
  126.    Gamma Software must be advised by any distributor charging any fee
  127.    for its distribution and the amount of such fees.  This will
  128.    insure that the distributor is kept up-to-date with the latest
  129.    version of FCOMP.  Gamma Software reserves the right to withdraw
  130.    distribution rights from any and all distributors.
  131.  
  132.    You are encouraged to pass a copy of FCOMP along to your
  133.    friends for evaluation.  Please encourage them to register their
  134.    copy if they find that they can use it.  All registered users
  135.    will receive a copy of the latest version of the FCOMP shareware
  136.    system and a printed manual.
  137.  
  138.  
  139. _____________________________________________________________________
  140.                                  ii
  141.  
  142.                             REGISTRATION 
  143. _____________________________________________________________________
  144.  
  145.  
  146.    HOW TO REGISTER
  147.    ---------------
  148.    When you execute the shareware version of the FCOMP program a
  149.    shareware registration screen is displayed at the beginning of
  150.    the program.  This screen describes the registration policy and
  151.    at the bottom of the screen there are 3 options.  To register 
  152.    FCOMP press the down arrow key to highlight the second option 
  153.    "Print Registration Invoice".  Then press Enter and the invoice 
  154.    will be printed to your printer (make sure your printer is on and 
  155.    on-line).  If for some reason the invoice does not print then type 
  156.    the following command: "PRINT FCINVOIC.DOC" at a DOS prompt (while 
  157.    in the FCOMP directory).
  158.  
  159.    The next step is to fill in the invoice and mail it to:
  160.  
  161.                         Gamma Software
  162.                         P.O. Box 8191
  163.                         Fort Collins, CO 80526
  164.  
  165.    along with a check or money order for $15 or fill in the required 
  166.    credit card information.
  167.  
  168.    A quicker way to register FCOMP is to call:
  169.  
  170.                         (800) 747-9960
  171.  
  172.    and we will take your credit card information over the phone and
  173.    ship your order.
  174.  
  175.    Purchase orders and COD orders are not accepted.
  176.  
  177.    If you wish to purchase a site license then you will also need to
  178.    print and fill in the form contained in the file "FCSITE.DOC".
  179.    Mail that form along with the invoice to the address above.  We
  180.    will ship 10 copies of the software with each site license.  You
  181.    may, of course, install the software on all computers at the given
  182.    site when you purchase a site license.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198. _____________________________________________________________________
  199.                                  iii
  200.  
  201.                                 INDEX
  202. _____________________________________________________________________
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.    Contents
  210.    --------                                             Page
  211.    Introduction ........................................   1
  212.      Getting Help ......................................   1
  213.      System Requirements ...............................   1
  214.      Manual Conventions ................................   2
  215.      Use of a Mouse ....................................   2
  216.    Getting Started .....................................   3
  217.    Command Syntax (batch) ..............................   4
  218.    Command Syntax (interactive) ........................   5
  219.    The File Selection menu .............................   6
  220.    The Comparison menu .................................   8
  221.       Display next difference ..........................   8
  222.       Save to file .....................................   8
  223.       Print ............................................   8
  224.       New compare ......................................   8
  225.       Help .............................................   8
  226.       Quit .............................................   8
  227.    Error Messages ......................................   9
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257. _____________________________________________________________________
  258.                                  iv 
  259.  
  260.                             INTRODUCTION 
  261. _____________________________________________________________________
  262.  
  263.  
  264.    The FCOMP program compares two text files and displays their
  265.    differences.  It can be run interactively or in batch mode.
  266.    This program is especially useful to programmers who want to
  267.    determine what changes were made in a source file from one
  268.    version to the next.  The files to be compared must be pure
  269.    ASCII text.  In other words word processor files that contain
  270.    binary formatting information cannot be used.
  271.  
  272.    In batch mode the files to be compared and the file to be used
  273.    as the output for the comparison are placed on the command line.
  274.    No other input is required from the user.  This mode is suitable
  275.    for use in a batch file.
  276.  
  277.    In interactive mode the program will prompt for 0 to 2 files
  278.    (depending on whether any were input on the command line) to
  279.    use in the comparison.  The files are input using a file selection
  280.    menu similar to the one used in Windows.  Once the files have been
  281.    compared the comparison is displayed in a scrollable window.  
  282.    Options within this menu include: displaying the next difference,
  283.    saving the comparison to a file, printing the comparison, Starting
  284.    a new comparison, help and quitting the program.
  285.  
  286.    About This Manual
  287.    -----------------
  288.    The FCOMP program is intended to be as easy to use as possible, but 
  289.    you should take a few minutes to go through the "Getting Started"
  290.    section of this manual.  The sections following "Getting Started" 
  291.    describe the different features available in the program.
  292.  
  293.    Getting Help
  294.    ------------
  295.    If you have a problem with the FCOMP then support may be obtained 
  296.    by writing to:
  297.       Gamma Software
  298.       P.O. Box 8191
  299.       Fort Collins, CO 80526
  300.    Please describe the problem in sufficient detail so that it can be
  301.    reproduced by us.
  302.  
  303.    Support may also be obtained by calling (303) 667-9960, 8am-5pm 
  304.    Mountain time (Mon-Fri).  It can also be obtained by sending mail 
  305.    to [73737,1721] on Compuserve.
  306.  
  307.    Support is currently free and unlimited.  We do reserve the right
  308.    to change these policies in the future.
  309.  
  310.    Requirements
  311.    ------------
  312.    - DOS 2.0 or later.
  313.    - IBM PC, XT, AT, PS/2 or compatible.
  314.    - 512k ram
  315.  
  316. _____________________________________________________________________
  317.                                   1 
  318.  
  319.                             INTRODUCTION 
  320. _____________________________________________________________________
  321.  
  322.  
  323.  
  324.    Manual Conventions
  325.    ------------------
  326.    When two keys need to be pressed simultaneously to perform a given
  327.    operation they are separated by a plus (+).  For example Shift+Tab
  328.    means to press the Shift key and hold it down while the Tab key is
  329.    pressed.  The arrow keys are denoted as Right, Left, Up and Down.
  330.    File names are in all capital letters.  There is an implied Enter
  331.    at the end of most commands (i.e. you must press the Enter key
  332.    after typing in the command).
  333.  
  334.    Using The Mouse
  335.    ---------------
  336.    This section describes the various mouse actions that are referred to
  337.    in the rest of this manual.  If the program detects a mouse driver
  338.    then the mouse will automatically be used by the program.  All the
  339.    keyboard functions still work unchanged.  If the mouse has been 
  340.    initialized then a rectangular mouse cursor should appear on the screen
  341.    when the program is loaded and move when the mouse is moved.  If a 
  342.    mouse cursor does not appear and you have a mouse make sure the mouse 
  343.    driver is loaded and the mouse has been installed properly (see the 
  344.    instructions that came with your mouse).
  345.  
  346.    When the manual says to "click on ..." then you should place the mouse
  347.    cursor over the field described after the text "click on" and press 
  348.    the left mouse button.  For example "click on the OK field" means to
  349.    position the cursor over the field that contains the text "OK" and 
  350.    press down and then release the left mouse button.
  351.  
  352.    When the manual says to "click and drag ..." then you should move the
  353.    mouse cursor over the object mentioned after the text "click and drag"
  354.    and then press and hold down the left mouse button.  Then move the
  355.    mouse until the desired result has been obtained.  Then release the
  356.    button.  For example "click and drag the scroll bar up or down" means
  357.    to move the mouse cursor over the scroll bar, press down and hold the 
  358.    left mouse button and then move the mouse up or down.  Release the left 
  359.    mouse button to end the operation.
  360.  
  361.    When the manual says to "double click on ..." then you should perform
  362.    the same operation as "click on ..." except that you should press the
  363.    left mouse button twice in rapid succession.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375. _____________________________________________________________________
  376.                                   2 
  377.  
  378.                            GETTING STARTED
  379. _____________________________________________________________________
  380.  
  381.  
  382.    This section will run you through a brief example demonstrating
  383.    how to use the program.  First change to the drive and directory 
  384.    containing FCOMP.  For example type commands similar to:
  385.    
  386.       C:
  387.       CD \UTILS
  388.  
  389.    at the DOS prompt.  The drive and directory will vary depending on 
  390.    where you installed FCOMP.
  391.  
  392.    The next step is to load the program by simply typing FCOMP at the
  393.    DOS prompt.
  394.  
  395.    Once loaded the program first displays a copyright screen and then
  396.    displays a shareware information screen (in the shareware
  397.    version).  Press Enter (or click on "Continue") to continue to the
  398.    file selection menu.  Press Alt+f to switch to the "Files" sub-menu
  399.    and then press the down arrow key until FCTEST1.TXT is highlighted.
  400.    Then press Enter.  You can also double-click on FCTEST1.TXT to
  401.    select it with the mouse.  Another file selection menu will
  402.    appear to allow you to select the second file to use in the
  403.    comparison.  Select FCTEST2.TXT.
  404.  
  405.    The program will then compare the 2 files and display the compari-
  406.    son.  At this point you can have the program highlight the
  407.    differences between the 2 files by pressing the "d" key or clicking 
  408.    on "Display next difference".  This is useful for locating the
  409.    differences in large files quickly.  The display can be scrolled
  410.    up and down and right and left with the arrow keys or by clicking
  411.    on the arrows at the end of the scroll bars.
  412.  
  413.    The comparison displays the lines that are the same to both files
  414.    in the middle.  Lines unique to the first file are displayed to
  415.    the left and lines unique to the second file are displayed to the
  416.    right.  You can save the comparison to file by pressing "s" and
  417.    entering an output file name in the file selection menu.  If you
  418.    want to better understand what the display represents, print it by
  419.    pressing the "p" key and then exit by pressing the "q" key.
  420.  
  421.    When you are back at the DOS prompt type the following commands:
  422.  
  423.       PRINT FCTEST1.TXT
  424.       PRINT FCTEST2.TXT
  425.  
  426.    and then compare the two files just printed with the comparison
  427.    you printed in the program.
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434. _____________________________________________________________________
  435.                                   3 
  436.  
  437.                             COMMAND SYNTAX
  438. _____________________________________________________________________
  439.  
  440.  
  441.    Batch
  442.    -----
  443.    To run this program in batch mode type the following command at a DOS
  444.    prompt.
  445.  
  446.       FCOMP file1 file2 outfile
  447.  
  448.    The parameters "file1" and "file2" should be replaced with the complete
  449.    path specification for the two files that are to be compared.  The
  450.    parameter "outfile" should be replaced with the path specification for
  451.    the file that is to contain the output of the comparison.  This file
  452.    is overwritten if it exists so care should be taken to give the 
  453.    proper path specification.
  454.  
  455.    The following is an example of a batch FCOMP command.
  456.  
  457.       FCOMP file1a.txt file1b.txt file1.cmp
  458.  
  459.    This command would compare FILE1A.TXT to FILE1B.TXT and place the
  460.    comparison in FILE1.CMP.
  461.  
  462.    In batch mode the program requires no further input from the user after
  463.    the command has been issued.  The two files are compared and the output
  464.    is placed in "outfile" automatically.  If one of the files cannot be
  465.    opened then the program issues an error and terminates.
  466.  
  467.    The comparison in "outfile" lists the lines that match from the two
  468.    inputs in the middle.  Those that are unique to "file1" are listed
  469.    to the left and those that are unique to "file2" are listed to the
  470.    right.  There is a header at the beginning of the comparison which
  471.    lists the files used and where their respective lines start in the 
  472.    comparison.
  473.  
  474.    The remainder of this manual deals with the interactive mode of FCOMP.
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493. _____________________________________________________________________
  494.                                   4 
  495.  
  496.                             COMMAND SYNTAX
  497. _____________________________________________________________________
  498.  
  499.  
  500.    Interactive
  501.    -----------
  502.    To run this program in interactive mode type the following at a DOS
  503.    prompt.
  504.  
  505.       FCOMP [/vxx] [file1 file2]
  506.  
  507.    The parameters enclosed in brackets are optional.
  508.  
  509.    The switch /vxx sets the video mode.  There are two forms of this 
  510.    switch: /v43 and /v50.  The switch /v43 tells the program to use the
  511.    43 line mode of EGA display devices and the /v50 switch sets the
  512.    program to use the 50 line mode of VGA display devices.
  513.  
  514.    The parameters "file1" and "file2" specify the two files to use in
  515.    the comparison.  You may specify just "file1" or "file1" and "file2".
  516.    You cannot specify "file2" unless you also specify "file1".  The  
  517.    program will prompt you for the file(s) you do not specify on the
  518.    command line.  See the next section "The File Selection Menu".
  519.  
  520.    The following are valid forms of the FCOMP command.
  521.  
  522.       FCOMP /v43 file1.txt file2.txt
  523.       FCOMP /v50 file1.txt file2.txt
  524.       FCOMP file1.txt file2.txt
  525.       FCOMP /v43 file1.txt
  526.       FCOMP file1.txt
  527.       FCOMP /v50
  528.       FCOMP
  529.  
  530.    In the shareware version of the program a registration reminder
  531.    screen appears after the FCOMP command is issued.  Press Enter or 
  532.    click on "OK" to continue.
  533.  
  534.    After the filenames for the two files to use in the comparison are
  535.    entered the program will display the comparison.  If the comparison
  536.    is too large to be completely displayed in the amount of memory
  537.    currently available to the program then the following message will
  538.    be issued.
  539.  
  540.       "Not enough memory to display entire comparison"
  541.  
  542.    Only a portion of the comparison will be displayed but the entire 
  543.    comparison can still be printed or saved to a file.  See the section
  544.    "The Comparison Menu" for more details.
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552. _____________________________________________________________________
  553.                                   5 
  554.  
  555.                        The File Selection Menu
  556. _____________________________________________________________________
  557.  
  558.  
  559.    This menu consists of 6 sections: the "Filename" field, the 
  560.    "Directory" field, the "Files" list, the "Directories" list, the "OK" 
  561.    button and the "CANCEL" button.  If a new file is being selected
  562.    then the "Files" list is absent.  To move to the next field press
  563.    the Tab key.  To move to the previous field press Shift and Tab at
  564.    the same time.  To move to another field using the mouse place the
  565.    mouse cursor over the desired field and click the left mouse button.
  566.    You may also move directly to the "Filename" field by pressing Alt+n.
  567.    You may move to the "Files" and "Directories" lists by pressing 
  568.    Alt+f and Alt+d, respectively.
  569.  
  570.    The "Filename" field is used to enter a filename directly or a 
  571.    wildcard specification to set the files displayed in the "Files" list.
  572.    For example if you want to display all files in the current directory
  573.    with the extension ".DOC" then enter "*.doc" in the "Filename" field
  574.    and press Enter or click on the "OK" button.  The "Files" list should 
  575.    then be updated.  If you specify a drive and/or directory in this field 
  576.    then the "Directories" list will also be updated when Enter is pressed.  
  577.    This field recognizes the standard DOS wildcards "*" and "?".  See your 
  578.    DOS manual for an explanation of wildcards.
  579.  
  580.    The "Directory" field displays the current directory.  You cannot 
  581.    edit this field directly.  It is updated when a new drive or directory
  582.    is selected from the "Directories" list or entered in the "Filename"
  583.    field.
  584.  
  585.    The "Files" list displays the files with the wildcard specification 
  586.    set in the "Filename" field and the directory listed in the "Directory"
  587.    field.  The up and down arrow keys and Page UP and Page Down keys are
  588.    used to highlight different files in the list.  Click on a filename to 
  589.    highlight it using the mouse.  The "Filename" field is updated with the 
  590.    currently highlighted filename.  Click on one of the scroll arrows on 
  591.    the right border to scroll the list with the mouse.  To scroll the 
  592.    "Files" list more quickly using the mouse, click and drag the scroll bar 
  593.    on the right border of the "Files" list.  When the desired file is 
  594.    highlighted press Enter or click the mouse on the "OK" button or double 
  595.    click on a file in the list to select it.  This ends the file selection.
  596.  
  597.    The "Directories" list displays the subdirectories and if one exists
  598.    the parent directory (denoted by "..") of the current path specified in 
  599.    the "Directory" field.  It also displays the drives installed on the
  600.    system at the end of the list.  You may scroll through this list in
  601.    the same way as the "Files" list, above.  The currently highlighted
  602.    directory is prefixed to the file specification in the "Filename"
  603.    field.  To select a drive or directory highlight it and press Enter
  604.    or click on the "OK" button or double click on the desired selection.
  605.  
  606.    The "OK" button is selected by moving to it with the Tab or Shift+Tab
  607.    keys and pressing Enter or by clicking on it with the mouse.
  608.  
  609.  
  610.  
  611. _____________________________________________________________________
  612.                                   6 
  613.  
  614.                        The File Selection Menu
  615. _____________________________________________________________________
  616.  
  617.  
  618.    The "CANCEL" button is selected by moving to it with the Tab or 
  619.    Shift+Tab keys and pressing Enter or by clicking on it with the mouse.
  620.    This exits the file selection menu without making a selection.  The
  621.    Escape key does the same thing.
  622.  
  623.    Selecting "OK", pressing Enter in the "Filename" field, selecting a
  624.    file in the "Files" list or selecting a drive/directory in the
  625.    "Directories" list does the following.  The contents of the "Filename" 
  626.    field is read and if a new drive, directory or file specification has 
  627.    been entered then the "Directory" field, the "Directories" list and the 
  628.    "Files" list are updated to reflect the values in the "Filename" field.  
  629.    The "Filename" field is then updated to contain only the file 
  630.    specification that was entered.  If the "Filename" field describes a 
  631.    unique file (i.e. no wildcards) then the program checks to see if the 
  632.    file exists.  If it does and an existing file is to be opened then the 
  633.    file selection ends.  If the file exists and a new file is to be 
  634.    selected then the program asks you if you want to overwrite it.  The 
  635.    space bar (or clicking on the yes/no field) toggles between yes and no.  
  636.    Tab to the "OK" field and press Enter or click on "OK" when the desired 
  637.    choice has been made.  Responding yes ends the file selection.  
  638.    Responding no returns you to the file selection menu.
  639.  
  640.    For example to open an existing file using the keyboard press Tab
  641.    4 times to get to the "Directories" list.  Press the down arrow key
  642.    until the desired drive is highlighted.  Press Enter.  Press Tab 4
  643.    times again and highlight the desired directory.  Press Enter.  Press
  644.    Tab 3 times to get to the "Files" list and highlight the desired file.
  645.    Press Enter.  This will exit the file selection menu.  If the 
  646.    "Directory" field already contains the proper path then you can skip
  647.    the first two steps and go straight to the "Files" list and select   
  648.    the desired file.  You can also type in the desired filename in the
  649.    "Filename" field and press Enter to select it.
  650.  
  651.    To open an existing file using the mouse, double click on the desired
  652.    drive from the "Directories" list.  Then double click on the desired
  653.    directory from that list.  Then double click on the desired file from
  654.    the "Files" list.  This will exit the file selection.  If the path in 
  655.    the "Directory" field is already correct then you can simply double
  656.    click on the desired file to select it and skip the first two steps.
  657.  
  658.    To open a new file then select the proper path if the one in the 
  659.    "Directory" field is not correct by selecting a drive and directory
  660.    in the "Directories" list.  Then type in the desired file name in
  661.    the "Filename" field and press Enter.  If the file does not exist
  662.    then the file selection menu will be exited.  If it does exist then
  663.    the program will prompt you to determine if it should be overwritten.
  664.    Answering yes will select the file and exit the file selection menu.
  665.  
  666.  
  667.  
  668.  
  669.  
  670. _____________________________________________________________________
  671.                                   7 
  672.  
  673.                          The Comparison Menu
  674. _____________________________________________________________________
  675.  
  676.  
  677.    The comparison lists the lines that match from the two inputs in the 
  678.    middle.  Those that are unique to "file1" are listed to the left and 
  679.    those that are unique to "file2" are listed to the right.  There is a 
  680.    header at the beginning of the comparison which lists the files used 
  681.    and where their respective lines start in the comparison.
  682.  
  683.    Scrolling
  684.    ---------
  685.    You may scroll through the comparison using the arrow keys and 
  686.    Page Up and Page Down keys.  Pressing the Ctrl key and the End key at 
  687.    the same time causes the comparison to be scrolled to the bottom.  
  688.    Pressing Ctrl+Home causes the comparison to be scrolled to the top.
  689.  
  690.    Placing the mouse cursor over one of the vertical or horizontal scroll
  691.    arrows on the border and clicking the left mouse button causes the
  692.    comparison to be scrolled in the direction of the arrow.  To scroll the
  693.    comparison more quickly place the mouse cursor over the vertical scroll 
  694.    bar (on the right border) or over the horizontal scroll bar (at the
  695.    bottom).  Then click the left mouse button and hold it down.  Then move
  696.    the mouse in the direction you want to scroll (left/right if over the
  697.    horizontal bar or up/down if over the vertical bar).  Release the left
  698.    mouse button when the comparison has been scrolled to the desired 
  699.    position.
  700.  
  701.    Searching
  702.    ---------
  703.    You may search for a given text string within the comparison by pressing
  704.    Alt+f.  This will bring up a menu that prompts you for the string to
  705.    search for.  Enter the desired string and press Enter or press Esc to
  706.    terminate the command (clicking the left mouse button while the mouse
  707.    cursor is outside the pop-up menu also terminates the command).  The
  708.    previous search string is remembered so if you want to search for the
  709.    same string again press Alt+f and the pop-up menu should contain the
  710.    last text string entered.  If you press Enter to accept this string 
  711.    then the next occurrence of the string will be found.  If the given 
  712.    text string is found then it is highlighted.  If the string is not 
  713.    found then the following message will be displayed along the bottom
  714.    border.
  715.  
  716.        "Pattern not found."
  717.  
  718.    The comparison is always searched from the current position towards
  719.    the end.  Therefore if the string you are searching for lies above
  720.    the currently displayed position in the comparison the string will 
  721.    not be found.
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729. _____________________________________________________________________
  730.                                   8 
  731.  
  732.                          The Comparison Menu
  733. _____________________________________________________________________
  734.  
  735.  
  736.    Options
  737.    -------
  738.    The menu bar at the top of the comparison lists the options available.
  739.    To select an option press the first letter of the desired option or
  740.    place the mouse cursor over the desired option and click the left
  741.    mouse button.  The following sections describe the available options.
  742.  
  743.    Display next difference
  744.    -----------------------
  745.    This option is selected by pressing the "d" key or clicking on this
  746.    option in the menu bar with the mouse.  The file is then positioned
  747.    to the next difference in the comparison.  If there are no more 
  748.    differences then the following text is displayed in the bottom border.
  749.  
  750.       "No more differences"
  751.  
  752.    Save to file
  753.    ------------
  754.    This option is selected by pressing the "s" key or clicking on this
  755.    option in the menu bar with the mouse.  The file selection menu is 
  756.    then displayed.  Enter the name of the file you want to output the
  757.    comparison to.  See the section "The File Selection Menu" for more
  758.    details.  Once a file name has been entered the program writes the
  759.    current comparison to that file.
  760.  
  761.    Print
  762.    -----
  763.    This option is selected by pressing the "p" key or clicking on this
  764.    option in the menu bar with the mouse.  The current comparison is  
  765.    then printed.  If the program detects an error sending the comparison
  766.    to the printer then the following message will appear.
  767.  
  768.       "Make sure printer is ON LINE"
  769.  
  770.    Press Enter to continue if the above error message is displayed.  The 
  771.    printer needs to be hooked up, powered on and on-line when this 
  772.    command is invoked.  
  773.  
  774.    New compare
  775.    -----------
  776.    This option is selected by pressing the "n" key or clicking on this
  777.    option in the menu bar with the mouse.  The program will then bring
  778.    up the file selection menu so that you may enter two files for a new
  779.    comparison.
  780.  
  781.    Help
  782.    ----
  783.    This option is selected by pressing the "h" key or clicking on this
  784.    option in the menu bar with the mouse.  A help screen is then 
  785.    displayed.  Press Enter or click on the OK field to return to the
  786.    comparison menu.
  787.  
  788. _____________________________________________________________________
  789.                                   9 
  790.  
  791.                          The Comparison Menu
  792. _____________________________________________________________________
  793.  
  794.  
  795.    Quit
  796.    ----
  797.    This option is selected by pressing the "q" key or clicking on this
  798.    option in the menu bar with the mouse.  The program then terminates.
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847. _____________________________________________________________________
  848.                                  10 
  849.  
  850.                             Error Messages
  851. _____________________________________________________________________
  852.  
  853.  
  854.    Error messages are either displayed and the program terminates or
  855.    they appear in a pop-up dialogue box.  In this second case press
  856.    Enter or click on the "OK" field to continue.
  857.  
  858.    The following is a list of errors issued by the program, what they
  859.    mean and what can be done to correct them, if anything.
  860.  
  861.  
  862.    "Can't find match at file1 line nnn file2 line nnn"
  863.       The program searched thru the maximum number of lines in each file
  864.       without finding a match.  The files are too different to be  
  865.       compared.  The "nnn" values give the line numbers where the program
  866.       could no longer find a match.
  867.  
  868.    "Can't open compare temporary file"
  869.       The program stores the comparison in a temporary file named 
  870.       CMP#0001.TMP when run in interactive mode.  This file is created
  871.       in the current directory.  For some reason this file could not be
  872.       opened.  For example: out of disk space or program is run from a
  873.       floppy disk that is write protected.
  874.  
  875.    "Can't open first compare file"
  876.       The program could not open the first compare file as specified on
  877.       the command line or as input in the file selection menu in 
  878.       interactive mode.  Check to make sure the path is correct.
  879.  
  880.    "Can't open compare output file"
  881.       The program could not open the compare output file specified on
  882.       the command line in batch mode.  Check the path specification for
  883.       this file to make sure it is valid.  Check to make sure there is
  884.       enough disk space on the given drive.  Make sure the floppy is not
  885.       write protected if outputting to a floppy.
  886.  
  887.    "Can't open second compare file"
  888.       The program could not open the second compare file as specified on
  889.       the command line or as input in the file selection menu in 
  890.       interactive mode.  Check to make sure the path is correct.
  891.  
  892.    "Could not open file."
  893.       This error is issued by the file selection menu.  It is usually 
  894.       caused by entering a filename in the "Filename" field that does not
  895.       exist.
  896.  
  897.    "Filename too long"
  898.       This error occurs if the complete path specification for a file 
  899.       input in the file selection menu is longer than 128 characters.
  900.  
  901.    "First filename too long"
  902.       This error occurs if the path specified on the command line for 
  903.       the first file is longer than 128 characters.
  904.  
  905.  
  906. _____________________________________________________________________
  907.                                  11 
  908.  
  909.                             Error Messages
  910. _____________________________________________________________________
  911.  
  912.  
  913.    "Invalid /v switch"
  914.       The program issues this error if a /v switch other than /v43 or
  915.       /v50 is input on the command line.
  916.  
  917.    " Invalid path specification! "
  918.       This error is issued by the file selection menu.  It is usually 
  919.       caused by entering an invalid path in the "Filename" field or
  920.       clicking on an invalid drive in the "Directories" list.  For example
  921.       clicking on "[-A-]" when there is no disk in the A: drive.
  922.  
  923.    "Line nnn is too long"
  924.       This error is caused by a line in one of the two comparison files
  925.       being longer than 511 characters.  Check to make sure that both
  926.       input files are text files with each line terminated by a carriage 
  927.       return and a line feed.
  928.  
  929.    "Make sure printer is ON LINE"
  930.       The program issues this error when the "Print" option is selected
  931.       from the menu bar and an error is detected writing the current 
  932.       comparison to the printer.  Make sure the printer is connected,
  933.       turned on and on line when the print option is invoked.
  934.  
  935.    "Not enough memory to display entire comparison"
  936.       When comparing large files there may not be enough memory to display
  937.       the entire comparison in the comparison menu.  When this error is
  938.       issued as much of the comparison as possible is displayed in the 
  939.       comparison menu.  The entire comparison can still be printed or 
  940.       saved to a file using the "Print" and "Save to file" options, 
  941.       respectively, from the menu bar.  Freeing up more memory by 
  942.       removing any TSR's currently loaded may eliminate the problem.
  943.  
  944.    "Out of memory"
  945.       This error is only issued in extreme cases where there is not enough
  946.       memory to create one of the menus.  Free up more memory by removing
  947.       any TSR's that are not needed.
  948.  
  949.    "Output filename too long"
  950.       This error occurs if the path specified on the command line for 
  951.       the output file is longer than 128 characters.
  952.  
  953.    "Second filename too long"
  954.       This error occurs if the path specified on the command line for 
  955.       the second file is longer than 128 characters.
  956.  
  957.    "Unknown switch"
  958.       The program issues this error when a switch is input on the command
  959.       line which it does not recognize.  The only switches that are 
  960.       currently valid are /v43 and /v50.
  961.  
  962.  
  963.  
  964.  
  965. _____________________________________________________________________
  966.                                  12 
  967.